home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 34 / Mac Magazin and MacEasy Magazine CD - Issue 34.iso / Grafik & Text / Alpha ƒ / Help / HTML Help < prev    next >
Text File  |  1997-04-01  |  93KB  |  2,193 lines
  1.                          HTML mode version 1.4.1
  2.     
  3.                         Copyright by Johan Linde
  4.                               April 1997
  5.                                                  
  6. Use the marks menu [M] ------------------------------------------------- >> 
  7. to quickly jump to different sections of this file.
  8.  
  9. There is also an HTML formatted version of this manual, with lots of screen
  10. shots. You can find it in the folder HTML mode manual. (Not included in 
  11. AlphaLite.)
  12.  
  13. HTML Mode is for editing HyperText Markup Language documents (suffix 
  14. ".html", ".htm" or ".shtml"). Whenever you open or save a file with any of 
  15. these suffixes, Alpha switches to HTML mode and inserts the HTML mode menu 
  16. in the menu bar. You can also manually switch to HTML mode with the popup 
  17. mode menu in the status bar.
  18.  
  19. HTML mode does not teach you HTML. Therefore you have to know at least 
  20. some HTML to use it.  If you do not know about HTML, I recommend that you 
  21. read "A Beginner's Guide to HTML".  It is a good first text to read.  
  22. You can find it at
  23. http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html 
  24. I have collected some other links to HTML guides. See the section on
  25. HTML Tutorials and references.
  26.  
  27. The basic idea with this HTML environment is to save you time while typing, 
  28. by having key bindings for all HTML elements.  Also, you do not have to 
  29. worry about misspelt HTML tags, missing end quotes, or missing end tags.  
  30. HTML mode is probably most useful for HTML programmers with some experience 
  31. of HTML, who are looking for an editor that makes the editing easier and 
  32. faster.
  33.  
  34. When you use this package, by default you will see bullet characters (•), 
  35. called "tab marks", being dribbled near where you insert elements.  These 
  36. are supposed to be a feature.  The tab key takes you to the next one and 
  37. automatically deletes the bullet.  Read the section "How to use tab marks"
  38. to learn to use them in the best way.
  39.  
  40. ===============================================================================
  41. = HTML mode features
  42. ===============================================================================
  43.  
  44. • HTML mode knows HTML 3.2 and Netscape's extensions to HTML.
  45. • Tools to easily and quickly insert HTML elements and give them 
  46.   attributes. Each element has its own key binding.
  47. • Tools to easily change or remove HTML elements.
  48. • Tools for building lists and tables.
  49. • You can define colors with a color picker to use on your web pages.
  50. • You can check that all links between your files are OK.
  51. • You can move files between folders and automatically update all links 
  52.   between and in them.
  53. • Support for dynamically included files.
  54. • Conversion of NCSA and CERN image map files to client side image maps.
  55. • Support for editing of JavaScript.
  56. • Translation of special characters, å, ó, ü etc.  to 
  57.   and from their HTML entities.
  58. • Files are sent to your browser with one key stroke.
  59. • Any menu item can be bound to any single key stroke.
  60. • You can define new HTML elements. Therefore you don't have to wait for 
  61.   Alpha to be updated to use it for new HTML.
  62. • etc. etc.
  63.  
  64. Acknowledgment
  65.  
  66. First of all, I would like to thank Pete Keleher for writing Alpha, the 
  67. best editor in the world, without which my TCL code would be pretty 
  68. useless.  I am also indebted to Scott Brim who wrote an earlier version of 
  69. Alpha's HTML mode.  Some ideas and tcl code were taken from html.el for GNU 
  70. Emacs and latex.tcl for Alpha.  François Pottier gave me lots of help with 
  71. the code which makes Alpha talk to Big Brother.  The algorithm for 
  72. extracting the width and height of JPEG images were written by Alex Knowles 
  73. and Andrew Tong.  Many thanks to Michael O'Henly for making the wonderful 
  74. Alpha HTML mode intro site.  He has also who sent me a list with 
  75. corrections of the language in this manual.  (Don't blame him for the 
  76. remaining errors!)  And thanks to everybody who has sent me suggestions and 
  77. bug reports.  You know who you are.
  78.  
  79. I want feedback! All comments on HTML mode are welcome. Many features in 
  80. HTML mode were suggested by HTML mode users. Don't hesitate to send me 
  81. your ideas. In particular, please tell me
  82. • about bugs of any kind,
  83. • about new feature you want to have included in the HTML mode,
  84. • if you think some function behaves stupidly,
  85. • if some HTML element is not defined correctly,
  86. • if something is not explained well enough in this help file.
  87.  
  88. You may also tell me that you like HTML mode. :-)
  89.  
  90. I have a page http://bach.theophys.kth.se/~jl/Alpha.html where you can 
  91. download new versions of HTML mode before they are included in the general 
  92. Alpha distribution.
  93.  
  94. If you want to be notified about new releases, including beta releases, 
  95. send me a mail and I'll put you on my mailing list.
  96.  
  97.                                 Johan Linde <jl@theophys.kth.se>
  98.  
  99. HTML mode is free.  This means that it may be used freely, and distributed 
  100. freely, as long as the receiver is not obligated in any way by receiving it.  
  101. HTML mode consists of the files html.tcl, htmlCustom.tcl, htmlElems.tcl, 
  102. htmlEngine.tcl, htmlExtra.tcl, htmlMenu.tcl, htmlMode.tcl, htmlUtils.tcl, 
  103. this help file and the HTML formatted manual in the folder HTMLmanual.
  104.  
  105. However, Alpha itself is not free. It's shareware.
  106.  
  107. Writing HTML mode has taken a considerable amount of time.  Therefore, if 
  108. you like HTML mode and use it a lot, I would very much appreciate if you 
  109. send me a colorful postcard and tell me that.  It would give me new energy 
  110. to add new features to HTML mode.  Note that emails don't count as 
  111. postcards.  Emails are not pretty enough to put on the wall. My address is
  112.  
  113. Johan Linde
  114. Lojovägen 61
  115. S-181 47 LIDINGÖ
  116. SWEDEN
  117.  
  118. ===============================================================================
  119. = Language
  120. ===============================================================================
  121.  
  122. My mother tongue is Swedish.  Therefore you will, no doubt, find 
  123. grammatical and other errors in this document and in HTML mode.  Please 
  124. tell me about any such error you find -- in a menu, dialog box, error 
  125. message...
  126.  
  127. But before you complain, I must tell you that I know that "color" is spelt 
  128. "colour".  :-)
  129.  
  130. ===============================================================================
  131. = Version history
  132. ===============================================================================
  133.  
  134. Version 1.4.1, 2 April 1997
  135.  
  136. • A few changes to the HTML 3.2 package to make it agree with the final 
  137.   recommendation from W3C 14 January 1997.
  138. • Alpha can now optionally save a window without asking when you send it 
  139.   to your browser.
  140. • If you have more than one version of the same browser and one is running, 
  141.   Alpha no longer tries to launch the second one when you send a file to 
  142.   the first one.
  143. • You can now set the line width of your HTML documents (fillColumn 
  144.   variable).
  145. • A couple of bug fixes. In particular a bug which in a few cases would 
  146.   extract the wrong width and height of gifs and jpegs has been fixed.
  147.  
  148. Version 1.4, 21 January 1997
  149.  
  150. • Files outside home page folders are considered to have URLs like 
  151.   file:///path/to/file.html.  This implies that you can now check links 
  152.   between all files, not only the ones in your home page folders.  Similarly 
  153.   you can make links via a file dialog between all files, and 
  154.   cmd-double-click now works for all files.
  155. • Improved integration with Big Brother. (You need Big Brother 1.1 or 
  156.   later.)
  157. • Each home page folder can have a corresponding include folder, where you 
  158.   can put all your files to be dynamically included. This include folder is 
  159.   mapped to the same URL as the home page folder.
  160. • 'Move files' works for files in these new include folders.
  161. • 'Update folder' and 'update file' for include files.
  162. • Case-sensitive link checking.
  163. • You can now choose if you want to check anchors when you check links.
  164. • Unsafe characters in URLs are coded when they are inserted, e.g. space 
  165.   becomes %20.
  166. • Long opening tags are wrapped when they are inserted.
  167. • Cmd-double-click on an include tag opens file.
  168. • Home page URLs no longer have to be specified in two pieces.
  169. • 'Check links' didn't work for anchors with spaces. Fixed.
  170. • 'Check folder' can now optionally check subfolders.
  171. • 'Convert NCSA map' couldn't correctly translate circle areas. Fixed.
  172. • When image maps are converted, the default URL is now put last.
  173. • color_9 ... color_15 can be used as keyword color.
  174. • The predefined colors are replaced by the 16 ones defined in HTML 3.2.
  175. • HTML manual can be opened from the menu.
  176. • Added onReset to FORM.
  177. • Added HEIGHT to TABLE.
  178. • SHAPE=DEFAULT removed from HTML 3.2 package.
  179. • ALT is now correctly a required attribute of AREA.
  180. • A couple of other minor changes and bug fixes.
  181.  
  182. Version 1.3, 17 November 1996
  183.  
  184. • New submenu 'Browsers' where you can add all your browsers, and quickly
  185.   choose which one to send files to. ('Choose browser' is gone, and as a 
  186.   concequence changed the key binding for SCRIPT back again.)
  187. • 'Check links' now checks anchors.
  188. • Fixed a bug in 'Check links' for links like HREF="#anchor" in files 
  189.   containing a <BASE HREF="url">.
  190. • Improved error handling in 'Move files' and 'Update home page'.
  191. • Fixed a bug with include tags split into two lines.
  192. • 'Includes' now works for paths containing the characters "<>.
  193. • Similar fix for 'last modified date'.
  194. • A few other minor changes and fixes.
  195.  
  196. Version 1.3b2, 4 November 1996
  197.  
  198. • The HTML prefs file (if any) sometimes wasn't loaded in 1.3b1. Fixed.
  199. • Modified 'Table template'.
  200. • New 'Tabs to Rows' dialog.
  201. • Function to import a table from a file.
  202. • 'Make list' can now optionally insert list tags.
  203. • Untitled windows could not be sent to browser. Fixed.
  204. • Updating dynamically included files now changes last modified date.
  205. • Importing an exported URL cache missed first URL. Fixed.
  206. • You can now go back in 'Clean up cache' dialog.
  207. • BASEFONT added to HTML 3.2 package. (Included in the latest draft from 
  208.   W3C.)
  209. • Described in this help file how to easily bind any menu item to any single
  210.   keystroke.
  211.  
  212. Version 1.3b1, 22 October 1996
  213.  
  214. • You can now define more than one home page folder, each containing files 
  215.   of different sites.
  216. • Support for dynamically included files.
  217. • Conversion of NCSA and CERN image map files to client side image maps.
  218. • New interface for defining colors. You can now also define a color by 
  219.   specifying its hexadecimal number.
  220. • New interface for footers.
  221. • When selecting a GIF or JPEG file for <IMG> via a file dialog its width 
  222.   and height are automatically determined. The algorithm for JPEG is taken 
  223.   from the perl script 'wwwimagesize' by Alex Knowles, alex@ed.ac.uk, 
  224.   and Andrew Tong, werdna@ugcs.caltech.edu.
  225. • The URL cache can be exported to a file for later use.
  226. • You can scan any file for URLs and import them to the URL cache.
  227. • The names of the files in a folder can be imported to the URL cache.
  228. • 'Last modified date' can automatically be inserted when you save a file.
  229. • Link checking can be done with Big Brother by François Pottier.
  230. • Function to change choices directly in the document.
  231. • Translation of <>&.
  232. • A user friendly settings dialog.
  233. • Cmd-double-click on a color attribute brings up a color picker and let 
  234.   you change the color.
  235. • Ctrl-q to skip the rest of the attributes in status bar.
  236. • Required attributes are asked for again in status bar.
  237. • Links checks can be done in the current window.
  238. • 'Comment' and 'Comment line' insert HTML comment or JavaScript comment 
  239.   depending on the position.
  240. • Funcs menu lists headers H1-6.
  241. • Function to select the content of a container.
  242. • Shift-ctrl-opt-space bound to  
  243. • Table template optionally without TABLE tags.
  244. • Comment color in JavaScript coloring can be changed.
  245. • 'Reveal color' has moved to new 'Editing' sub menu, and has got a new key 
  246.   binding.
  247. • Added ARCHIVE and MAYSCRIPT to APPLET.
  248. • Some other minor changes.
  249.  
  250. Version 1.2.2, 3 October 1996
  251.  
  252. • You can now change browser for preview (option on 'send file to browser').
  253.   As a consequence, the key binding for SCRIPT is changed.
  254. • 'Check links', 'Move files' and cmd-double-click now correctly interpret
  255.   links like HREF="#anchor" as pointing to the file itself and not to 
  256.   "index.html#anchor".
  257. • The same functions now ignores "news:" links like they always have ignored
  258.   "mailto:" links.
  259.  
  260. Version 1.2.1, 12 September 1996
  261.  
  262. • 'Move files' no longer remove blank lines in the moved files.
  263. • Special window names _self _top _parent _blank correctly set to lowercase.
  264. • 'Mark file' didn't find header when opening tag was split into two 
  265.   lines. Fixed.
  266. • HTTP-EQUIV is no longer a required attribute of META.
  267. • Value of NAME attribute to A, MAP and FRAME wasn't added to cache when 
  268.   tags were set in lowercase. Fixed.
  269.  
  270. Version 1.2, 3 August 1996
  271.  
  272. • The package HTML 2.0 is removed, since it is out-dated. From now on 
  273.   there will only be two packages, one with the latest official HTML and 
  274.   one where extensions have been included.
  275. • There is now only two way to input attributes, the dialogs introduced 
  276.   in 1.1 and the status bar.
  277. • Improved behavior when attributes are given in the status bar. ctrl-z to 
  278.   cancel, ctrl-f for a file dialog or new color. When a value is chosen 
  279.   from a popup window, Alpha immediately jumps to the next attribute.
  280. • A new user friendly way to add new HTML elements.
  281. • A function to move files between folders and automatically update all 
  282.   links to and in them.
  283. • Changed JavaScript coloring. Only reserved words are colored, not built 
  284.   in methods and properties. Comments in JavaScript are now colored.
  285. • A window cache just like the URL cache. Frame names are automatically added 
  286.   to this cache.
  287. • A new submenu with plug-ins.
  288. • JavaScript's event handlers can now optionally appear in the attribute dialog.
  289. • Only one menu item for <A>.
  290. • Added SRC to <SCRIPT>.
  291. • Added <NOSCRIPT>, <MULTICOL> and <SPACER>.
  292. • Added FRAMEBORDER, BORDERCOLOR to <FRAME>.
  293. • Added FRAMEBORDER, BORDERCOLOR, BORDER to <FRAMESET>.
  294. • Added FACE to <FONT>.
  295. • Added onMouseOut to <A>.
  296. • Added onAbort, onError, onLoad to <IMG>.
  297. • Added onClick, onMouseOver, onMouseOut to <AREA>.
  298. • When trying to add a link via a file dialog, windows with ' <n>' added to 
  299.   the window name were asked to be saved even if they already were saved.  
  300.   Fixed!
  301. • Send file to browser didn't work for windows with ' <n>' appended. Fixed!
  302. • Problems finding the browser fixed.
  303. • Reveal color didn't find color attribute if color wasn't quoted. Fixed!
  304. • Check links didn't find BASE if it was split into two lines. Fixed!
  305. • Check links and cmd-double-click now correctly interpret paths of the form
  306.   "./file.html".
  307. • Check links and cmd-double-click now search for a file index.html when a 
  308.   link points to a folder.
  309. • Check links didn't work for files with UNIX or IBM newlines. (All links 
  310.   were found to be ok.) Fixed!
  311. • Some lists couldn't be inserted when using the status bar. Fixed!
  312. • 'Change opening' didn't work for INPUT elements in lower case. Fixed!
  313. • The variable htmlElemAttrsForAll is no longer supported.
  314. • Some other minor changes and bug fixes.
  315.  
  316. Version 1.1.1, 17 June 1996
  317.  
  318. • Rewrote some of the code so that HTML mode loads faster.
  319. • The menu Use Attributes is disabled when it is not needed.
  320. • Added <U> and <NOEMBED>.
  321. • The new suffix mapping is used to determine if a file is a HTML file 
  322.   when deciding which files to scan to check the links.
  323.  
  324. Version 1.1, 21 May 1996
  325.  
  326. • The HTML elements are put into three packages, HTML 2.0, HTML 3.2 and 
  327.   Extensions.
  328. • Support for JavaScript coloring and editing.
  329. • A function to check that all links between files in your home page are ok.
  330. • Attributes to an element can be input in one single dialog box, 
  331.   rather that giving the attributes one after another.
  332. • When you are asked about an URL attribute, you can choose a file via a 
  333.   file dialog. The relative path is automatically inserted.
  334. • "Fill paragraph" is now sensitive to HTML elements.
  335. • cmd-doubleclick on a relative URL opens the file, or if it does not 
  336.   exits, it can create a new file and save it in the right place.
  337. • You can define a new color when you are asked about a color attribute.
  338. • You can define files with footers, which can be automatically inserted 
  339.   when you create a new document.
  340. • Control that a value given to a number attribute is valid.
  341. • Control that a value given to a color attribute is valid.
  342. • New dialog box for "New document" where you can choose which elements 
  343.   you want in the head, and also select a file with a footer to insert in the 
  344.   end of the body.
  345. • Character translation can be done in a selection. The translation is also
  346.   a lot faster.
  347. • Tab marks can be removed in a selection.
  348. • "Select container" and "Untag" now find the correct pair of tags when 
  349.   there are elements of the same kind within each other, like a <TABLE> within 
  350.   a <TABLE>.
  351. • "Select container" and "Untag" now ignores all tags without a closing tag.
  352. • A function to select a tag with no closing tag.
  353. • A function to untag a element with no closing tag.
  354. • A function to untag a container and automatically select the content.
  355. • A function to change an element in the document.
  356. • New key binding for untag: ctrl-F1. It has been bundled with the new functions 
  357.   just mentioned.
  358. • Mark file now finds headers with opening and closing tags on different 
  359.   lines. Each menu item is limited to 30 characters, not to make them too long.
  360. • If you use any of the two old ways of inputting attributes, you can 
  361.   set a flag for each element, so that you can optionally be asked about the 
  362.   attributes not chosen in the "Use attributes" menu.
  363. • A table template function, to quickly make tables.
  364. • With "Tabs to rows" you can now optionally put table headers in first 
  365.   row and/or column.
  366. • "Rows to tabs" now follow the HTML code, not the line breaks in the file.
  367. • A function to insert <BR> at the end of every line in a selection.
  368. • A function to remove every <BR> in a selection.
  369. • A function to insert <P> at empty lines in a selection.
  370. • A function to make a HTML list from a *'d list.
  371. • Undo is now easier, although you sometimes still have to make two "Undos" 
  372.   to undo something.
  373. • For attributes which can take any value, beginning and ending spaces are
  374.   no longer removed. Sometimes these spaces are wanted.
  375. • When <A NAME="xxx"> or <MAP NAME="xxx"> is inserted, "#xxx" is added to 
  376.   URL cache.
  377. • New dialog box for cleaning up URL cache.
  378. • Two identical colors can no longer be defined.
  379. • New elements STRIKE and DFN.
  380. • New element <INPUT TYPE=BUTTON> in extensions package. To be used 
  381.   together with JavaScript.
  382. • A couple of new attributes added so some elements.
  383. • For the AREA element, a check is made that you use one of the attributes 
  384.   HREF and NOHREF is used, but not both.
  385. • The key binding for "Comment line" have been changed to ctrl-C-L to 
  386.   conform with other modes.
  387.   
  388. Version 1.0, 25 March 1996
  389.  
  390. • A lot of new elements are included.
  391. • It's possible to define colors to use as background color, text color etc. 
  392.   from a color picker.
  393. • Translation of accented letters (é, á etc.) to HTML entities and vice versa.
  394. • The attributes of the elements are divided into required and optional ones.
  395.   If you skip a required one, no element is inserted. You can no longer make 
  396.   elements like <A></A>.
  397. • For some elements there is a separate key binding as well as menu item to
  398.   automatically skip all attributes.
  399. • Improved behavior when the status bar is used to input attributes.
  400. • Untagging works better.
  401. • Marking of the file works better.
  402. • Plus a number of other small changes.
  403.  
  404. ===============================================================================
  405. = Known bugs / limitations
  406. ===============================================================================
  407.  
  408. The first three are general Alpha bugs beyond my control and may have been 
  409. fixed by the time you read this.
  410.  
  411. • Switching coloring of JavaScript keywords on or off has no effect until 
  412.   you switch to another window.
  413. • Disabled menu items can be accessed from a palette.
  414. • Sometimes when you undo, Alpha doesn't redraw the text correctly. (Ctrl-L 
  415.   to redraw the window.)
  416. • Sometimes you have to undo twice to undo something. (This is a 
  417.   workaround to avoid this redraw bug as much as possible.)
  418. • 'Check links' and 'move files' don't recognize comments.
  419. • 'Check links' and 'move files' only search for strings like HREF="file" 
  420.   without checking that they are inside a tag.
  421. • 'Move files' only updates files in the home page folder where you move 
  422.   files and doesn't update files in other home page folders.
  423. • If you use 'save all', windows not at the front are brought to front 
  424.   when saved. (This is not exactly a bug, it is only unusual behavior.)
  425. • 'Change choice' for EMBED assumes general EMBED.
  426.  
  427. ===============================================================================
  428. = Configuring HTML mode
  429. ===============================================================================
  430.  
  431. There are several functions in HTML mode for maintaining one or more www 
  432. sites.  To be able to use these functions in the best way you have to tell 
  433. Alpha which folder contains the files of a www site.  To do this use 'Home 
  434. pages' in the menu 'HTML Utilities'.  The idea is that each of those 
  435. folders, together with their subfolders, should contain all your html files 
  436. at a server and be a mirror of your home page at the corresponding server.
  437.  
  438. In the dialog window you have the following:
  439.  
  440. Server URLs: a menu with the current home pages for which you have a folder.
  441.  
  442. Home Page Folder: The folder corresponding to the home page selected in 
  443. the menu.
  444.  
  445. Include Folder: The include folder corresponding to the home page selected 
  446. in the menu.
  447.  
  448. Default file: The default file corresponding to the home page selected in 
  449. the menu.
  450.  
  451. Tip: Use the up and down arrows to navigate in the menu.
  452.  
  453. New: To define a new home page folder. You are presented with a second 
  454. dialog where you should set the following:
  455.  
  456.     Home Page Folder: The folder corresponding to the home page.
  457.     
  458.     Include Folder: A folder where you can put your files to be dynamically 
  459.     included. This folder is mapped to the same URL as the home page folder.
  460.     To define an include folder is optional. Read more about dynamically 
  461.     included files here.
  462.     
  463.     Server URL: The URL to your home page, for example 
  464.     http://www.somewhere.net/~myplace/
  465.     
  466.     Default file: The file which is used if a link points to a directory.  
  467.     This name depends on the configuration of your server, but is usually 
  468.     index.html.
  469.  
  470. Change: To change the home page selected in the menu.
  471.  
  472. Remove: To remove the home page selected in the menu.
  473.  
  474. Tell Big Brother: If you check this check box, the URL mappings will be 
  475. changed in Big Brother's settings, when you click OK. Big Brother is told 
  476. which home page folders map to which URLs.  Big Brother is a shareware 
  477. program for checking links by François Pottier, Francois.Pottier@inria.fr.  
  478. You can get Big Brother from his home page, http://pauillac.inria.fr/~fpottier/
  479.  
  480.  
  481. ===============================================================================
  482. = The HTML Packages
  483. ===============================================================================
  484.  
  485. The HTML elements are put into two packages, which can be loaded 
  486. separately.
  487.  
  488. HTML 3.2 - Contains everything in HTML 3.2 as in the recommendation by World 
  489.            Wide Web Consortium released 14 January 1997. 
  490.  
  491. Extensions - Contains everything in HTML 3.2 plus extensions to 
  492.             HTML.
  493.  
  494. You have probably heard of HTML 3.0.  It was a proposal for extending HTML 
  495. published in March 1995.  HTML 3.0 was never widely deployed.  HTML 3.2, on 
  496. the other hand, adds widely deployed features such as tables, applets and 
  497. text flow around images, while providing backwards compatibility with the 
  498. old standard HTML 2.0.
  499.  
  500. ===============================================================================
  501. = How to use tab marks (•)
  502. ===============================================================================
  503.  
  504. When you insert HTML elements via the HTML menu you will see bullet 
  505. characters (•), called tab marks, being inserted after the element.  These 
  506. tab marks are supposed to be a feature.  The way to use them is the 
  507. following: Suppose you want to insert a header H1.  First choose "Header 1" 
  508. from the menu (and give the attribute a value if you want).  In the 
  509. document will now be inserted
  510.  
  511. <H1></H1>
  512.  
  513. •
  514.  
  515. with the insertion point between the H1 tags.  Now first type the header 
  516. text:
  517.  
  518. <H1>My header</H1>
  519.  
  520. •
  521.  
  522. When you have done so, hit tab and the insertion point will jump to the 
  523. tab mark and delete it.  You are now ready to continue typing.
  524.  
  525. If your document has been cluttered with tab marks, which you do not want 
  526. to use, you can remove them all with cmd-tab.  If you do not want to use 
  527. tab marks at all, you can change Alpha's behavior in the settings dialog, 
  528. so that the tab marks are not inserted.
  529.  
  530. ================================================================================ 
  531. = Text wrapping 
  532. ================================================================================
  533.  
  534. It is very easy to insert an HTML element in an existing text.  For example, 
  535. suppose that in some text there is the word "important" which you want in 
  536. boldface. First select the word, then choose "Bold" from the menu (or type the 
  537. equivalent key binding) and "important" will be wrapped by the HTML tags to 
  538. give <B>important</B>.  This behavior is the same for all elements which 
  539. are containers.  Inserting an HTML element never deletes a selection.
  540.  
  541. ===============================================================================
  542. = Coloring
  543. ===============================================================================
  544.  
  545. The text in your HTML files can be colored in two different ways. By 
  546. default all HTML tags are colored blue, like
  547.  
  548. <A HREF="file.html">a link somewhere</A>
  549.  
  550. In the settings dialog you can tell Alpha to change the coloring and also 
  551. color JavaScript keywords.  These are then colored magenta.  But the 
  552. coloring of the HTML tags also changes, like
  553.  
  554. <INPUT TYPE="BUTTON" VALUE="pi" onClick="piKnapp(this.form)">
  555.  
  556. While this coloring is primarily intended to be used for files with 
  557. JavaScript, it can also be a better choice for files with very little text 
  558. and mostly HTML tags.  Have in mind though that JavaScript keywords 
  559. (if else this...)  will be colored even when they are part of ordinary 
  560. text.
  561.  
  562. Bug: When you change the way of coloring, nothing happens until you switch 
  563. to another window.
  564.  
  565. ================================================================================
  566. = Funcs menu
  567. ================================================================================
  568.  
  569. If you press the two curly braces in the right hand corner of the window 
  570. (the so called 'funcs menu'), this menu will display an item for each 
  571. header H1-6 in your file.  You can then easily jump to a header by 
  572. selecting it in the menu.  The menu items are truncated after 30 
  573. characters, to prevent them from becoming too long.
  574.  
  575. ================================================================================
  576. = How HTML mode behaves when it asks for attributes to an HTML element.
  577. ================================================================================
  578.  
  579. If an HTML element has attributes, they can be asked about in two different 
  580. ways: either in a dialog box with all attributes (the default), or in the 
  581. status bar.  In the settings dialog you can change which of these two ways 
  582. you want to use.
  583.  
  584. The attributes can be divided into eight categories: URLs, colors, target 
  585. windows, predefined choices (for example ALIGN=LEFT|CENTER|RIGHT), numbers, 
  586. flags, event handlers, and other.  The category 'other' contains attributes 
  587. which can take any value plus some which do not fit into any of the other 
  588. categories.
  589.  
  590. Using dialog boxes.
  591.  
  592. In the settings dialog you can tell Alpha to include JavaScript's event 
  593. handlers in the dialog.  By default they are not included.
  594.  
  595. URLs     -    You can specify the URL in three ways:
  596.             1) type the URL in the text box,
  597.             2) choose one from the menu with your URL cache,
  598.             3) select a file via a file dialog. The file you have 
  599.             selected will be put in the menu.
  600.             
  601.             It is probably much faster to type the URL than selecting a 
  602.             file from a file dialog, but the advantage to using the file 
  603.             dialog is that it will automatically insert a correct absolute 
  604.             or relative URL depending on which is appropriate.  If you use 
  605.             a BASE tag in the current window it will be noticed.
  606.             
  607.             Files inside home page folders are mapped to a URL 
  608.             http://as.you.have.defined.it/file.html
  609.             and files outside the home page folders are mapped to a URL
  610.             file:///path/to/file.html
  611.             
  612.             Alpha first determines the URL of the two files, and then 
  613.             determines the URL to link between them.
  614.             *) If you link within a home page folders you will get a 
  615.             relative URL.
  616.             *) If you link between two different home page folders like 
  617.             http://here.net/ and http://there.net/ you will get an absolute 
  618.             URL.
  619.             *) If you link between two different home page folders like 
  620.             http://www.net/~me/ and http://www.net/~you/ (at the same 
  621.             server), you will get a relative URL.
  622.             
  623.             You can also make links between files which are not in a home 
  624.             page folder, but linking between files, where one inside a home 
  625.             page folder and the other one is not, may not always make 
  626.             sense.
  627.             
  628.             If you type a URL in the text box, it will be used even if you 
  629.             choose something from the menu.
  630.  
  631.             If you select a GIF or JPEG file for the attribute SRC to IMG 
  632.             via a file dialog, the attributes WIDTH and HEIGHT are 
  633.             automatically determined.  The algorithm for JPEGs is taken 
  634.             from the perl script 'wwwimagesize' by Alex Knowles, 
  635.             alex@ed.ac.uk and Andrew Tong, werdna@ugcs.caltech.edu
  636.             
  637. Colors    -    You can specify the color in three ways:
  638.             1) type a hexadecimal number #RRBBGG, which defines the color, 
  639.             in the text box,
  640.             2) choose a color from the menu,
  641.             3) define a new color.  The color so defined will be put in the 
  642.             menu.
  643.             
  644.             If you type something in the text box, it will be used, even if 
  645.             you choose a color from the menu.
  646.  
  647. Window    -    You can specify the target window in two ways:
  648.             1) type the window name in the text box,
  649.             2) choose a window name from the menu with your window cache.
  650.             
  651.             If you type something in the text box, it will be used, even if 
  652.             you choose a window from the menu.
  653.             
  654. Predefined choices - Select a choice from the menu.
  655.  
  656. Numbers -    Attributes which take an integer value. The numbers will be 
  657.             checked that they are in the valid range.
  658.  
  659. Other    -    Attributes which can take any value.  Note that spaces in the 
  660.             beginning and end of what you type are not removed.  (This is 
  661.             always done otherwise.)  This is because sometimes such spaces 
  662.             are wanted.
  663.  
  664. Flags    -    These are attributes which does not take any value. Check the 
  665.             checkbox to use it.
  666.  
  667. Event handlers - Attributes which are event handlers for JavaScript.
  668.  
  669. If an element has very many attributes, the dialog box may have to be 
  670. divided into two, or possibly three, pages to fit your screen.  Then there 
  671. will be a menu in the upper left corner of the dialog box to switch between 
  672. the pages.  The dialog box is made as large as possible before being split 
  673. into two or three pages, so if your screen is large enough this will never 
  674. happen.
  675.  
  676. Alpha will complain if you forget a required attribute, and in most cases 
  677. it will complain if you give a value to an attribute which is not valid.
  678.  
  679. Using the status bar.
  680.  
  681. By default not all attributes are asked about.  Use the menu Use Attributes 
  682. to determine which attributes you want to be asked about.  There you can 
  683. also set a flag 'Ask for more?'  for each element.  If you answer yes, the 
  684. following will happen when you are asked about attributes for this element:
  685. *) You are first asked about the ones you have selected via this menu.    
  686. *) Then you get a question "More attributes?"    
  687. *) If you answer yes, you will then be asked about the rest of the 
  688. attributes.
  689. The idea is that you can put a kind of halfway mark.  First you are asked 
  690. about the ones you always want to be asked about, and then you are 
  691. optionally asked about the rest.
  692.  
  693. If you told Alpha to include event handlers in the dialog, JavaScript's 
  694. event handlers will be asked about for those elements to which you have set 
  695. 'Ask for more' to yes.
  696.     
  697. By default, Alpha beeps for each attribute it asks you about.  You can turn 
  698. off the beeps in the settings dialog.
  699.  
  700. You can simply type the value you want for an attribute (for colors you can 
  701. either type a number #RRBBGG or a color name), but some keys have special 
  702. functions to speed up your work.
  703.     
  704. tab - If you are asked about an attribute with predefined choices, for 
  705.     example ALIGN=LEFT|CENTER|RIGHT, tab will match what you have typed 
  706.     against your options, and attempt to complete what you have typed.  
  707.     Suppose you type C and then tab.  The letters ENTER will then 
  708.     automatically be inserted.  The same is true if you are asked for a 
  709.     URL, a target window or a color.  Tab will then match against your URL 
  710.     cache, the window cache or the color names defined.
  711.           
  712. double tab - If there are predefined choices or you are asked for a URL, 
  713.     a color or a target window, double tab will put up a list with 
  714.     everything that match what you have typed so far.  If you, for example, 
  715.     have forgotten which choices there are, hit double tab without typing 
  716.     anything to get a list with all possible choices.  Once you have chosen 
  717.     something from the list, Alpha immediately jumps to ask you about the 
  718.     next attribute.
  719.           
  720. cmd-v Pastes the clipboard into the status bar.  This is useful, for 
  721.     example, if you want to insert a URL which you have in another file.
  722.           
  723. ctrl-f - If you want to select a file via a file dialog when asked for a URL, 
  724.     or define a new color when asked for a color, type ctrl-f in the 
  725.     status bar.  Once you have selected a file or defined a new color, 
  726.     Alpha immediately jumps to ask you about the next attribute.
  727.  
  728.     If you select a GIF or JPEG file for the attribute SRC to IMG via a 
  729.     file dialog, the attributes WIDTH and HEIGHT are automatically 
  730.     determined.  Just hit return for the WIDTH and HEIGHT attributes and 
  731.     the automatically determined values will be used.
  732.     
  733. ctrl-q Skips the current and subsequent attributes.  You do not have to 
  734.     go through the whole list of attributes.
  735.  
  736. escape - Deletes everything written.
  737.     
  738. ctrl-z - Cancel everything.
  739.     
  740. If there are predefined choices, only the letters which match a choice can 
  741. be typed.  If you type anything else you just get a beep.  Also, when there 
  742. are predefined choices, if you have typed a unique subset of one of them 
  743. and hit return, the rest will be added.  For example, if the choices are 
  744. ALIGN=LEFT|CENTER|RIGHT and you type R and then return, you will get 
  745. ALIGN=RIGHT. If what you have typed is not unique, the attribute will be 
  746. skipped.  There are a few cases when two letters are needed to get a unique 
  747. choice.
  748.     
  749. Giving no value at all to an attribute means that you skip it.  If you try 
  750. to skip a required attribute, it is asked for again.
  751.  
  752. ===============================================================================
  753. = Editing JavaScript
  754. ===============================================================================
  755.  
  756. HTML mode has support for editing and coloring of JavaScript.  To use this 
  757. you have to change the default configuration in the settings dialog.  The 
  758. following settings concern JavaScript:
  759.  
  760. Color JavaScript keywords
  761. If checked, keywords and comments in JavaScript will be colored.  The way 
  762. the HTML tags are colored is also changed because the old way does not work 
  763. well with JavaScript.  By default it is not checked, do not color 
  764. JavaScript's key words.
  765.  
  766. Electric left braces
  767. When checked, the left braces, {, will be electric like in C mode.  Check 
  768. this if you are editing JavaScript.  That { is electric means that a 
  769. carriage return will automatically be inserted and the next line will be 
  770. indented when you type {. By default it is not checked, { is not electric.
  771.  
  772. Electric right braces
  773. When checked, the right braces, }, will be electric like in C mode.  Check 
  774. this if you are editing JavaScript.  By default it is not checked, } is not 
  775. electric.
  776.  
  777. Include event handlers in attribute dialog
  778. When checked, the event handlers (onFocus onSelect etc.)  will appear in 
  779. the attribute dialog.  By default it is not checked, no event handlers in 
  780. the attribute dialog.
  781.  
  782. Color of JavaScript keywords
  783. The color of keywords in JavaScript.  Applies only if you choose to color 
  784. JavaScript keywords. The default is magenta.
  785.     
  786. Color of JavaScript comments
  787. The color of comments in JavaScript.  Applies only if you choose to color 
  788. JavaScript keywords. The default is red.
  789.  
  790. Color of strings
  791. The color of everything between quotes.  Applies only if you choose to 
  792. color JavaScript keywords.  The default is green.
  793.  
  794. If you do not have an American keyboard, you may have to set two key 
  795. bindings to be able to use the electric left and right braces.  For 
  796. example, on my Swedish keyboard { is shift-opt-8 and } is shift-opt-9.  To 
  797. use the electric braces I have to bind these keys with
  798.  
  799. bind '8' <so> electricLeft        HTML
  800. bind '9' <so> electricRight        HTML
  801.  
  802. This is put in HTML's preference file, via the menu Config -> Current 
  803. mode -> Edit Prefs. Change your key bindings similarly if needed.
  804.  
  805. ================================================================================
  806. = Key Bindings
  807. ================================================================================
  808.  
  809. All HTML elements have their own key bindings.  You can find them all in 
  810. the HTML menu.  I have tried to group them as much as possible so that they 
  811. are easy to learn.
  812.  
  813. Other key bindings not found in the menu:
  814.  
  815. tab         Jump to the next tab mark (•)
  816. shift-tab    Jump to the previous tab mark (•)
  817. opt-tab        Literal tab
  818. cmd-tab     Remove all •
  819.  
  820. shift-ctl-opt-,         inserts <
  821. shift-ctl-opt-.            inserts >
  822. shift-ctl-opt-7            inserts &
  823. shift-ctl-opt-space        inserts  
  824.  
  825. Defining your own key bindings.
  826.  
  827. Any menu item in HTML mode can be bound to any single keystroke.  The way 
  828. to bind a function is with a statement such as:
  829.   
  830.     bind 'c' <modifier string> {htmlMenuItem "submenu" "menu item"} HTML
  831.           
  832. where c is a character, <modifier string> is an optional string containing 
  833. one or more of:
  834.  
  835.     c   - command modifier
  836.     o   - option modifier
  837.     s   - shift modifier
  838.     z   - control modifier
  839.  
  840. For example, to bind 'Check Window' to ctrl-opt-W, use the statement
  841.     
  842.     bind 'w' <zo> {htmlMenuItem "Check Links" "Check Window"} HTML
  843.  
  844. As another example, to bind 'Import Table…' to ctrl-shift-J, use the 
  845. statement
  846.  
  847.     bind 'j' <zs> {htmlMenuItem "Tables" "Import Table"} HTML
  848.     
  849. Such statements can be put in your HTML prefs file.  Use Config 
  850. -> Current Mode -> Edit Prefs.  If a menu item ends with three dots … the 
  851. dots must be omitted in the above statement defining the key binding.  If a 
  852. menu item is renamed or moved in a later version of HTML mode, remember 
  853. that you have to change your key bindings.  For more information about key 
  854. bindings, see the general manual for Alpha.
  855.  
  856. ===============================================================================
  857. = Command-double-click
  858. ===============================================================================
  859.  
  860. Command-double-clicking on an absolute URL sends the URL to your web 
  861. browser.  This is not limited to HTML mode.  It is a general feature of 
  862. Alpha.
  863.  
  864. Command-double-clicking on a relative URL opens a new window with the file 
  865. if the file exists and it is a text file.  If it does not exist, a new 
  866. empty window can be opened with the name of the file.  This window is 
  867. automatically saved in the right place, and if necessary new folders are 
  868. created.  Thus, if you are making a new set of pages, you can make links to 
  869. the ones you have not written yet and then, by cmd-double-clicking, let 
  870. Alpha make empty files which are saved where you want them.
  871.  
  872. Command-double-clicking on a color attribute brings up a color picker where 
  873. you can change the color.
  874.  
  875. Command-double-clicking on an 'include tag' opens the file.
  876.  
  877. ===============================================================================
  878. = The HTML Menu
  879. ===============================================================================
  880.  
  881. The menu described here is for the Extensions package. In the 
  882. HTML 3.2 package some menu items are absent.
  883.  
  884. The menus are dynamic. Holding down the option key changes some menu 
  885. items.
  886.  
  887. Browsers    -    To send a document to a browser for viewing, and to select 
  888.                 browsers with which to view documents.  The browser 
  889.                 currently marked in this menu is the one your documents 
  890.                 will be sent to when you use 'Send File to Browser'.  To 
  891.                 change browser, select the browser's menu item to mark it.
  892.                 (You can of course add any kind of program to this menu.  
  893.                 Alpha is not so clever that it can tell which ones are 
  894.                 browsers.)
  895.                 
  896.     Send File to Browser - Launches your browser and sends the document to it.
  897.     
  898.                 You can only have one version of each browser in the menu, 
  899.                 but you can still send files to any version from Alpha.  
  900.                 Let's say you have Netscape 2.0 and 3.0, and that 3.0 is 
  901.                 the one which appears in the menu.  Now launch Netscape 
  902.                 2.0.  Then if you send a window to the browser Alpha will 
  903.                 send it to Netscape 2.0 although you had 3.0 selected the 
  904.                 menu.  If any version of Netscape is running Alpha will 
  905.                 send the window to that one.
  906.                 
  907.                 This is useful when you want to make sure your document 
  908.                 looks OK in older versions of Netscape or any other browser, 
  909.                 for example to make sure that your megacool JavaScript 
  910.                 written for Netscape 3.0 doesn't produce a bazillion error 
  911.                 alerts in 2.0.
  912.                 
  913.                 Two comments about Internet Explorer 3.0 (the only version I 
  914.                 have tested):
  915.                 *) If you use Internet Config and have defined Netscape (for 
  916.                 example) to be the helper for the file protocol, Internet 
  917.                 Explorer will send the file to Netscape.  To be able to 
  918.                 send files to Internet Explorer either don't define any 
  919.                 helper for the file protocol in Internet Config or define 
  920.                 it to be Internet Explorer.                
  921.                 *) Internet Explorer opens a new window every time you send 
  922.                 a file to it. This is not an Alpha bug.
  923.     
  924.     Add…    -    Lets you select a browser and adds it at the bottom of this 
  925.                 menu.
  926.     
  927.     Remove… -    To remove a browser from the menu.
  928.  
  929. Help    -        Opens this file.
  930.  
  931. <opt>Manual -     Opens the HTML formatted version of this help file in your 
  932.                 browser.
  933.  
  934. Packages    -    To choose which package of HTML elements to use.  (See 
  935.                 the section abut the HTML packages.)  If you change 
  936.                 package, the HTML menu is rebuilt.
  937.  
  938. HTML Utilities  -
  939.     Colors…    -    You can define and name colors to use as background, text 
  940.                 and link color etc. on your www page.  Later, when you 
  941.                 insert an element with a color attribute, you can choose 
  942.                 the color for the attribute from a menu.  A set of 16 basic 
  943.                 colors is provided by default.  These are the 16 color 
  944.                 names defined in HTML 3.2. The predefined colors do not 
  945.                 show up in this dialog because you are not allowed to 
  946.                 change them.
  947.     
  948.                 In the popup menu in the dialog window are all color names 
  949.                 you have defined.  Below is the hexadecimal number 
  950.                 corresponding to the color selected in the menu. 
  951.                 
  952.                 Tip: Use the up and down arrows to navigate in the menu.
  953.                 
  954.                 Use
  955.                 
  956.                 New to define a new color with a color picker.
  957.                 
  958.                 Change to change a color with a color picker.
  959.                 
  960.                 Remove to remove the color selected in the menu.
  961.                 
  962.                 New by number to define a new color by specifying its 
  963.                 hexadecimal number #RRBBGG.
  964.                 
  965.                 Change number to change a color by changing its hexadecimal 
  966.                 number #RRBBGG.
  967.                 
  968.                 View to view a color in a color picker.  (Clicking OK and 
  969.                 Cancel in this picker have the same effect.  No changes are 
  970.                 saved.)
  971.  
  972.     Home Pages… - To define which folders contain the files of different sites, 
  973.                 see the section about how to configure HTML mode.
  974.                 
  975.     Footers… -    A footer is a file with text which you automatically can 
  976.                 put into the BODY of the document when you create a new 
  977.                 document.  To use this function,
  978.                 *) first create a file with the text which you want to use 
  979.                 on many of your pages -- for example, directory buttons, your 
  980.                 address etc.
  981.                 *) then define the file to be a footer.
  982.                 
  983.                 When you later use "New document" you can select this file 
  984.                 from a menu, and its content will be put inside the BODY 
  985.                 element.
  986.                 
  987.                 These files can of course contain any kind of text but I 
  988.                 call them footers because my basic idea is that they should 
  989.                 contain things you put at the bottom of every page.
  990.  
  991.                 In the popup menu in the dialog window are the file names 
  992.                 of the footers you have defined.  Below is the full path 
  993.                 corresponding to the file selected in the menu.  The 
  994.                 buttons have the following functions.
  995.     
  996.                 New -  Presents you with a file dialog to pick a file with 
  997.                        a footer.  This does not insert any text in your 
  998.                        document. It only defines a file to be a footer.
  999.                 
  1000.                 Remove - Removes the footer selected in the menu. Note: this 
  1001.                        does not delete the file. It is just no longer a 
  1002.                        footer.
  1003.                 
  1004.                 Insert - Inserts the footer selected in the menu in the 
  1005.                        document.
  1006.  
  1007.     Editing -    Functions for easier and quicker editing.
  1008.         
  1009.         Select Container -    Selects matching tags which include the current 
  1010.                         position or selection.  Repeated, it expands the 
  1011.                         selection.  Like the "Balance" item under the Edit 
  1012.                         menu.  All tags without a corresponding closing tag 
  1013.                         are ignored.
  1014.             
  1015.     <opt>Select Opening     -    If the first tag to the left of the current 
  1016.                         position is a tag without a corresponding closing 
  1017.                         tag, it is selected.  Repeated it jumps to the next 
  1018.                         one.
  1019.  
  1020.         Select in Container - Same as 'Select Container' except that only the 
  1021.                         content of the container is selected, not the 
  1022.                         enclosing tags.
  1023.  
  1024.         Untag    -        Removes a tag pair surrounding the current position 
  1025.                         or selection.  All tags without a corresponding 
  1026.                         closing tag are ignored.
  1027.                 
  1028.     <opt>Untag and Select -    Same as Untag, but the text inside the container is 
  1029.                         selected.  Use this if you want to change one 
  1030.                         container to another.
  1031.                 
  1032.         Remove Opening - If the first tag to the left of the current 
  1033.                         position is a tag without a corresponding closing 
  1034.                         tag, it is removed.
  1035.                 
  1036.         Change Container -     To change the attributes of the element enclosing 
  1037.                         the current position or selection.  A dialog box 
  1038.                         appears where the current values of all attributes 
  1039.                         are shown.  Change the ones you want and a new tag 
  1040.                         will be inserted in the text.
  1041.                 
  1042.                         If the element you want to change contains anything 
  1043.                         HTML mode does not understand, a warning message 
  1044.                         will first be shown.  If you decide to insert a new 
  1045.                         tag, everything HTML mode does not understand will 
  1046.                         be removed.
  1047.                 
  1048.                         If you are using JavaScript, the event handlers 
  1049.                         will only be shown in the dialog if you have 
  1050.                         checked 'Include event handlers in attribute 
  1051.                         dialog' in the settings dialog.  Otherwise, the 
  1052.                         event handlers are left untouched in the document.
  1053.                 
  1054.     <opt>Change Opening - Same as change container, but for an element with 
  1055.                         no closing tag.  The tag must be the first one to 
  1056.                         the left of the current position to be found.
  1057.                 
  1058.                         As you probably have noticed the logic for finding 
  1059.                         tags is the same for "Select" "Untag/Remove" and 
  1060.                         "Change".
  1061.                 
  1062.                         *) Container: the tags enclosing the current 
  1063.                         position or selection.  All tags without a 
  1064.                         corresponding closing tag are ignored.
  1065.                 
  1066.                         *) Opening: the first tag to the left must be a tag 
  1067.                         without a corresponding closing tag.
  1068.                 
  1069.                         It can be a good idea to first select the container 
  1070.                         or opening tag, before removing or changing them, 
  1071.                         to make sure you select the one you want.
  1072.  
  1073.         Change Choice -    To change an attribute with predefined choices, 
  1074.                         without bringing up a dialog window.  Put the 
  1075.                         insertion point at an attribute with predefined 
  1076.                         choices.  'Change Choice' will then change the 
  1077.                         attribute to the next choice in the list of 
  1078.                         choices.  Use 'Change Choice' several times to go 
  1079.                         through the list.
  1080.  
  1081.         Reveal Color -     If you move the current position to, or select any 
  1082.                         part of, a color attribute in the document and then 
  1083.                         choose "Reveal color", the number will be replaced 
  1084.                         with its name, and if you choose "Reveal color" 
  1085.                         again, the number appears again.  This is useful if 
  1086.                         you want to know what a cryptic color number stands 
  1087.                         for.  Do not forget that the browser only 
  1088.                         understands the number so do not leave the name in 
  1089.                         the document.
  1090.                         
  1091.         Remove Marks -     Remove tab marks, (•).  If some text is selected, 
  1092.                         the tab marks are removed within the selection, 
  1093.                         otherwise they are removed in the whole document.
  1094.                 
  1095.  
  1096.     Character Translation - To translate characters to and from their HTML 
  1097.                         entities.  If some text is selected, the characters 
  1098.                         are translated within the selection, otherwise they 
  1099.                         are translated in the whole document.
  1100.  
  1101.         åäö -> HTML -    translates characters to HTML entities.
  1102.         HTML -> åäö -    translates HTML entities to characters.
  1103.                         The characters which are translated are all that 
  1104.                         you find in the "Small Chars" and "Capital Chars" 
  1105.                         menus (except eth, thorn and y´) plus the Spanish ¡ 
  1106.                         and ¿.
  1107.                         
  1108.         <>& -> HTML -     translates the characters <>& to their HTML entities.
  1109.         HTML -> <>& -     translates them back again.
  1110.         
  1111.     URLs    -    Everything for managing the URL cache.  HTML mode 
  1112.                 accumulates a list of the URLs you use in your HREFs, SRCs 
  1113.                 etc., and saves the list across invocations of Alpha so it 
  1114.                 can help you to insert new URL attributes rapidly.
  1115.                     
  1116.         Clean Up… -        After a while the URL cache can get very large and 
  1117.                         you may want to remove some URLs you do not need.  
  1118.                         You will be presented with a dialog box with a 
  1119.                         checkbox for each URL in your cache.  Uncheck the 
  1120.                         ones you want to remove.  Click "Uncheck all" to, 
  1121.                         guess what, uncheck all checkboxes.  If there are 
  1122.                         more URLs in your cache than fit the window, there 
  1123.                         is a button "More" to take you to the next ones, and
  1124.                         a button "Back" to go back.
  1125.         
  1126.         Clear    -        Removes all URLs from your cache.
  1127.         
  1128.         Import…  -         Scans a file and imports all URLs found to the URL 
  1129.                         cache.
  1130.         
  1131.         Export…  -        Exports all URLs in the cache to a file for later use.
  1132.         
  1133.                         If you create several files with URLs and want to 
  1134.                         move the URLs between them, simply open the files 
  1135.                         and cut and paste.
  1136.             
  1137.         Add Folder… -    Adds the names of all files in a folder to the URL 
  1138.                         cache.  You can optionally add a path before the 
  1139.                         file name. For example, if you have a folder 'pics' 
  1140.                         with images, you might want to add 
  1141.                         'pics/file.gif' to the cache rather than only 
  1142.                         'file.gif'.
  1143.  
  1144.         Add Selection - Adds the current selection to the URL cache.
  1145.         
  1146.         Add Clipboard - Adds the clipboard to the URL cache.
  1147.         
  1148.     Windows -    Everything for managing the window cache.  HTML mode 
  1149.                 accumulates a list of the window names you use as target 
  1150.                 windows and saves the list across invocations of Alpha
  1151.                 so it can help you to insert new window attributes rapidly.
  1152.  
  1153.         Clean Up… -        Works in the same way as Clean up for the URL cache.
  1154.         
  1155.         Clear    -        Removes all windows from your cache.
  1156.                     
  1157.         
  1158.     Check Links - Functions to scan files and check that all links, HREFs, 
  1159.                 SRCs etc.  point to files which exist.  The files which are 
  1160.                 scanned are the HTML text files (the ones which have any 
  1161.                 of the suffixes as specified by the suffix mapping).  
  1162.                 For this to be useful the files in your home page folders 
  1163.                 must be mirrors of the files at your servers.  
  1164.                 If you use this function as intended you never have to 
  1165.                 worry about dead links between your files anymore.
  1166.                  
  1167.                 It works as follows: In every file scanned Alpha looks for 
  1168.                 all HREFs, SRCs, etc in the file.  If you use the BASE 
  1169.                 element it will be noticed and used to determine to which URL 
  1170.                 a link is pointing.
  1171.                 
  1172.                 Links to remote servers, which you don't have a home page 
  1173.                 folder for, are ignored.  Also, if you have a home page 
  1174.                 folder for http://www.net/~myplace/, links like 
  1175.                 http://www.net/file.html are ignored, as they are outside 
  1176.                 your home page.  For all other links, Alpha checks if the 
  1177.                 file exist.
  1178.                 
  1179.                 If any invalid links are found, a window is opened where 
  1180.                 the lines look as follows:
  1181.     
  1182.     file.html                   ; Line 8:    HREF="otherfile.html"
  1183.     file2.html                ; Line 23:  (anchor missing) HREF="file.html#anchor"
  1184.     folder:file3.html           ; Line 17:    (BASE used) SRC="pic/coolpic.gif"
  1185.     
  1186.                 In the first column is the name of the file with the link, 
  1187.                 including the path relative to the home page folder.  In 
  1188.                 the second column is the line number where the invalid link 
  1189.                 is, and in the third column is the link itself.
  1190.                 (anchor missing) means that the file exists but that the anchor
  1191.                 is missing in the file. 
  1192.                 (BASE used) means that the file contains a BASE element.  
  1193.                 Use the up and down arrows to select a line in this window, 
  1194.                 and carriage return to open the file and select the line 
  1195.                 with the invalid link.
  1196.                 
  1197.                 You can optionally check that the case of the links match 
  1198.                 the case of the file names on your disk.  This can be 
  1199.                 useful as Mac file names are not case sensitive, while for 
  1200.                 example unix file names are.  Therefore a link can work on 
  1201.                 your Mac but not work on a unix machine.  In the settings 
  1202.                 dialog you can tell Alpha to make a case sensitive link 
  1203.                 checking.  This is slower and therefore not done by 
  1204.                 default.
  1205.                 
  1206.                 Limitations: 
  1207.                 • If a link is within a comment, <!-- -->, it is 
  1208.                 still checked.
  1209.                 • Alpha only searches for strings like 
  1210.                 HREF="file" without checking that they are inside a tag. 
  1211.                 This means that Alpha could find links, which actually are 
  1212.                 not links.
  1213.  
  1214.         Check Window - Checks links in current window.
  1215.  
  1216.         Check Home Page    - Check links in all html files in a home page 
  1217.                         folder and its sub folders.
  1218.         
  1219.         Check Folder -    To check links in all files in one folder. You can 
  1220.                         optionally check the subfolders.
  1221.         
  1222.         Check File     -    To check links in a single file.
  1223.         
  1224.         Use Big Brother - Marks this menu item to indicate that link checks 
  1225.                         will be done with Big Brother instead of Alpha.  If 
  1226.                         this menu item is checked, files and folders will 
  1227.                         be sent to Big Brother when you check links.
  1228.                         
  1229.                         Some settings are temporarily changed in Big 
  1230.                         Brother, when you send a file or folder to it. These are
  1231.                         *) The URL mapping of your home page folders.
  1232.                         *) If subfolders should be searched or not.
  1233.                         *) Optionally you can tell Big Brother if it should 
  1234.                         ignore remote or local links.  This is done in the 
  1235.                         settings dialog.  By default Big Brother's settings 
  1236.                         for this are used.
  1237.         
  1238.                         Big Brother is a shareware program by François 
  1239.                         Pottier, Francois.Pottier@inria.fr.  You can get 
  1240.                         Big Brother from his home page, 
  1241.                         http://pauillac.inria.fr/~fpottier/
  1242.                 
  1243.                         The big advantage with Big Brother is that it can 
  1244.                         check all your remote links.  It checks local links 
  1245.                         on your hard disk with about the same speed as 
  1246.                         Alpha, but Big Brother can run in the background 
  1247.                         while you do other things.
  1248.                 
  1249.                         Other differences:
  1250.                         *) Big Brother understands all HTML 3.2 links, but 
  1251.                         not things like <FRAME SRC="url">                        
  1252.                         *) Alpha only searches for strings like HREF="url" 
  1253.                         and don't check that they are inside a tag, like <A 
  1254.                         HREF="url">.  Big Brother does that.
  1255.                         *) Big Brother recognizes comments while Alpha 
  1256.                         doesn't.
  1257.                         *) Big Brother doesn't check anchors.
  1258.                         *) Big Brother can't make case sensitive link checking.
  1259.                 
  1260.                         This comparison was done with Big Brother 1.1, 
  1261.                         and may of course not apply to later versions.
  1262.     
  1263.     Includes -    Function to dynamically include files in your document.  
  1264.                 Let's say you have a document where one part contains 
  1265.                 information which is updated frequently while the rest is 
  1266.                 almost never changed.  You can let the part which changes 
  1267.                 often be in another file and insert 'include tags' in the 
  1268.                 original document.  As another example, let's say some 
  1269.                 information is used in more than one document, perhaps if 
  1270.                 you make two versions of your home page, one with frames and 
  1271.                 one without.  You can then have this information in a 
  1272.                 separate file and and insert 'include tags' in the other 
  1273.                 ones.  In this way you only have to make a change at one 
  1274.                 place.  You can later quickly update your files and replace 
  1275.                 the text between the 'include tags'.
  1276.                 
  1277.                 When you define a home page folder, you can also define an 
  1278.                 include folder for it, where you can put all the 'include 
  1279.                 files'.  Although you can put these files anywhere you 
  1280.                 like, the include folder has certain advantages when the 
  1281.                 include files contain links.  Alpha maps the include folder 
  1282.                 to the same URL as the home page folder, and therefore 
  1283.                 treats the files in the include folder as if they were in 
  1284.                 the home page folder.  To see what I mean, consider the 
  1285.                 following example:
  1286.                 
  1287.                 *) Suppose you have a home page folder for http://www.net/ 
  1288.                 and have defined a corresponding include folder.
  1289.                 *) Make a subfolder 'testing' both in the home page folder 
  1290.                 and in the include folder.
  1291.                 *) Open a new file 'include.html' inside the subfolder 
  1292.                 'testing' in the include folder.
  1293.                 *) Make a couple of links from include.html.  Use the file 
  1294.                 dialog and select files in the home page folder.  You will 
  1295.                 see that the relative URLs will be constructed as if 
  1296.                 include.html was in the home page folder.
  1297.                 *) Now open a new file hi.html inside the subfolder 
  1298.                 'testing' in the home page folder.  Use 'Insert include 
  1299.                 tags' and select the file include.html in the include 
  1300.                 folder.  The links in hi.html will now be correct and you 
  1301.                 can send it to your browser and surf around.
  1302.                 
  1303.                 The idea with all this is that you don't have to clutter 
  1304.                 your home page folder with files which are not an actual 
  1305.                 part of your home page, and still take advantage of Alpha's 
  1306.                 functions to make links.
  1307.                 
  1308.                 For this to work the include file must be in a subfolder 
  1309.                 with the same name as the file(s) where it will be 
  1310.                 included.  You have to make sure you put the files in the 
  1311.                 right places yourself.  Alpha won't do that for you.
  1312.                 
  1313.                 A few of other things:
  1314.                 *) If you check links in include.html Alpha will look for 
  1315.                 files in the home page folder.
  1316.                 *) If you cmd-double-click a link in include.html, Alpha 
  1317.                 will open the file in your home page folder.
  1318.                     
  1319.         Insert Include Tags… - Asks you for a file to include, and inserts two 
  1320.                         tags inside comments and the content of the file,
  1321.                 
  1322.                         <!-- #INCLUDE FILE="path to file" -->
  1323.                         content of file
  1324.                         <!-- /#INCLUDE -->
  1325.                 
  1326.                         If you later change the content of the included 
  1327.                         file, you can quickly update the current document 
  1328.                         with the functions below.
  1329.                 
  1330.                         When you use character translation, the opening 
  1331.                         include tag is not translated to avoid making 
  1332.                         the path incorrect.
  1333.                         
  1334.                         If the path contains any of the characters <">#,
  1335.                         they are translated like 
  1336.                         # -> #; 
  1337.                         < -> #lt;
  1338.                         > -> #gt;
  1339.                         " -> #qt;
  1340.                         in order to make the tag unambiguous.
  1341.                 
  1342.         Update Window -    Replaces the text between all pairs of 'include 
  1343.                         tags' with the content of the file specified in the 
  1344.                         opening tags.
  1345.         
  1346.         Update Home Page - Replaces the text between all pairs of 'include 
  1347.                         tags' in all HTML files in a home page folder with the 
  1348.                         content of the file specified in the opening tags.
  1349.  
  1350.         Update Folder -    The same function for a folder.
  1351.         
  1352.         Update File -    The same function for a single file.
  1353.         
  1354.                         If you write anything between the 'include tags', 
  1355.                         it is only a temporary change.  The next time you 
  1356.                         update your document everything between the tags is 
  1357.                         replaced.
  1358.                         
  1359.                         If you remove 'include tags' in a document, make 
  1360.                         sure you remove both the opening tag and the 
  1361.                         corresponding closing tag.
  1362.                         
  1363.                         If a file contains 'last modified date' tags, the date
  1364.                         is changed if the file has been modified.
  1365.         
  1366.                         Recursive including of files is not supported, which 
  1367.                         means that if a file which is included also 
  1368.                         contains 'include tags' they are ignored, and the 
  1369.                         tags, but not the text between them, are removed 
  1370.                         before the text is inserted.
  1371.                         
  1372.     Extend     -    To add new HTML elements, or new attributes to existing 
  1373.                 elements, to HTML mode.  HTML is continuously evolving and 
  1374.                 many browsers have introduced their own extensions.  Here 
  1375.                 you can add what is missing.  New elements will be put in a 
  1376.                 new submenu 'Custom' of the HTML menu.
  1377.                 
  1378.                 You can only add new elements to the extensions package.  
  1379.                 HTML 3.2 is complete as it is.
  1380.                     
  1381.                 IMPORTANT! If you have previously defined new HTML elements 
  1382.                 in the preferences file HTMLPrefs.tcl (could be done in 
  1383.                 HTML mode 1.1.1 and earlier), make sure you remove all of 
  1384.                 them and restart Alpha before using this function.  
  1385.                 Otherwise there is a risk of conflicts between the two 
  1386.                 ways of adding elements.  If you have element definitions 
  1387.                 in your prefs file and you already have loaded HTML mode, 
  1388.                 you may have seen a warning message that the way to add new 
  1389.                 elements has changed.  This warning message is shown if you 
  1390.                 call the function htmlNewElemVar or define the variable 
  1391.                 htmlCustomMenuList.  Remove all such things from the prefs 
  1392.                 file and restart Alpha to avoid this warning.
  1393.                 
  1394.         New Element -     To add a new HTML element.
  1395.         
  1396.                         The elements are divided into three categories.
  1397.                         *) Normal.  All which are not of one of the other 
  1398.                         two categories.
  1399.                         *) Input element.  A <INPUT TYPE="xxx"> element for 
  1400.                         forms.
  1401.                         *) Plug-in. A plug-in using <EMBED>.
  1402.                         
  1403.                         In the first dialog you specify the following.
  1404.                         *) The name of the element.
  1405.                            For 'normal' elements simply give the name, for 
  1406.                            example to define <IMG> you would use 'IMG'.
  1407.                            For 'input elements' give the type, for example 
  1408.                            to define <INPUT TYPE=CHECKBOX> use 'CHECKBOX'.
  1409.                            For 'plug-ins', use any descriptive name you 
  1410.                            like.      
  1411.                         *) If the element has a closing tag </TAG> or 
  1412.                            not.  This only applies to 'normal' ones as 
  1413.                            neither <INPUT> nor <EMBED> has a closing tag.
  1414.                         *) A key binding for the element.  Type one 
  1415.                            character in the text box, and select which of the 
  1416.                            modifiers shift, control, option and command you 
  1417.                            want.  It is a bad idea to choose a key binding 
  1418.                            which conflicts with another one, but if it turns 
  1419.                            out that you have made a bad choice you can change 
  1420.                            it later.  If you do not want any key binding, 
  1421.                            leave the text box blank.
  1422.                         
  1423.                         Next you are asked to specify all the attributes to 
  1424.                         the element.  (I would say that it is a good idea to 
  1425.                         write down the complete definition on a piece of 
  1426.                         paper before you start.)
  1427.                         
  1428.                         In the first dialog for each attribute you specify:
  1429.                         *) Its name.
  1430.                         *) If it is a required attribute or not.
  1431.                         *) Its type.  Make sure you specify the correct 
  1432.                         type for each attribute.  For some types additional 
  1433.                         information must be given.  This is explained in 
  1434.                         detail below.
  1435.                         
  1436.                         The attributes you define will be displayed in the
  1437.                         dialog window as you go along.
  1438.                         
  1439.                         Then click
  1440.                         *) OK when you have given the above information for the 
  1441.                         current attribute.
  1442.                         *) 'No more attributes' *after* you have clicked OK 
  1443.                         for the last attribute.
  1444.                         *) 'Remove last' to remove the last attribute you just 
  1445.                         defined. You can remove them all one after another
  1446.                         to correct a mistake somewhere. 
  1447.                         
  1448.                         The different types are
  1449.                         
  1450.                         *) 'Other'.  Attributes that can take any value or 
  1451.                         do not fit into any of the other seven 
  1452.                         categories.  No additional information is needed.
  1453.                         
  1454.                         *) 'Number'.  Attributes which take an integer 
  1455.                         value.  For these, a second dialog box is shown, 
  1456.                         where you must specify the range of values 
  1457.                         accepted.  A minimum value must be given, but if 
  1458.                         there is no maximum value, leave the text box for 
  1459.                         this blank.  You should also specify if the value 
  1460.                         may be given in percent or not.
  1461.                         
  1462.                         *) 'Choices'.  Attributes which can only take 
  1463.                         certain predefined choices, such as 
  1464.                         ALIGN=LEFT|CENTER|RIGHT. For these attributes you 
  1465.                         must specify all valid choices in a second dialog 
  1466.                         box. The choices you define will be displayed in the
  1467.                         dialog window as you go along.
  1468.                           Click 
  1469.                         *) 'OK' for each choice
  1470.                         *) 'No more choices' *after* you have clicked OK for the 
  1471.                         last one.
  1472.                         *) 'Remove last' to remove the last choice you just 
  1473.                         defined. You can remove them all one after another
  1474.                         to correct a mistake somewhere. 
  1475.                         
  1476.                         *) 'Flag'.  Attributes which are flags and don't 
  1477.                         take any value, like ISMAP for <IMG> or NOHREF for 
  1478.                         <AREA>.  These attributes will be checkboxes in the 
  1479.                         attribute dialog.  No additional information is 
  1480.                         needed.
  1481.                         
  1482.                         *) 'URL'.  Attributes which take a URL as value, like
  1483.                         HREF, SRC, etc. No additional information is needed.
  1484.                         
  1485.                         *) 'Color'.  Attributes which take a color as 
  1486.                         value.  No additional information is needed.
  1487.                         
  1488.                         *) 'Window'.  Attributes which take a target window 
  1489.                         as value, like the attribute TARGET. No additional 
  1490.                         information is needed.
  1491.         
  1492.                         *) 'Event handler'.  Attributes which are event 
  1493.                         handlers for JavaScript.  No additional information 
  1494.                         is needed.
  1495.                         
  1496.                         Once you have specified all attributes you will be 
  1497.                         presented with a final dialog box, where you are 
  1498.                         asked which layout you want in the html documents.  
  1499.                         (This layout only determines how the tags are 
  1500.                         inserted in the text document, and affects, of 
  1501.                         course, not how the text is displayed by the 
  1502.                         browser.)
  1503.                         For elements without a closing tag you can specify 
  1504.                         if you always want a carriage return inserted 
  1505.                         before and/or after the tag.
  1506.                         
  1507.                         For elements with a closing tag, you can choose 
  1508.                         between four different layouts, whether you want 
  1509.                         the tags to be on lines of their own and if you 
  1510.                         want blank lines before and after them.
  1511.                         
  1512.                         The new element is now saved and after that, if 
  1513.                         you use the status bar to input attributes, you 
  1514.                         will be asked to select which optional attributes 
  1515.                         you want to be asked about (as described here).
  1516.                                                 
  1517.         New Attributes - To add new attributes to an existing HTML element.  
  1518.                         You are first presented with a list from which you 
  1519.                         choose an element to add attributes to.  In this 
  1520.                         list 'LI IN UL' and 'LI IN OL' are the LI element for 
  1521.                         UL and OL lists respectively.  BUTTON, CHECKBOX, 
  1522.                         FILE, HIDDEN, IMAGE, PASSWORD, RADIO, RESET, SUBMIT 
  1523.                         and TEXT are the INPUT element with different 
  1524.                         TYPEs.  LIVEAUDIO, LIVEVIDEO, QUICKTIME MOVIE, 
  1525.                         QUICKTIME VR and REALAUDIO are different plug-ins.  
  1526.                         All the rest are the usual names of the elements.  
  1527.                         Then you specify the attributes in the same way as 
  1528.                         you specify the attributes to a new element as 
  1529.                         described above.
  1530.         
  1531.         New Choices    -    To add new choices to an attribute with predefined 
  1532.                         choices.  You are first presented with a list from 
  1533.                         which you choose the element with the attribute to 
  1534.                         add to.  Second, you are presented with a list from 
  1535.                         which you select the attribute.  Then you specify 
  1536.                         new choices in the same way as described above.
  1537.         
  1538.         Change Key Binding - To change a key binding for a custom element.  
  1539.                         To remove the key binding, leave the text box 
  1540.                         blank.  Note that you can only change the key 
  1541.                         bindings for the elements you have added yourself.
  1542.                         
  1543.         Change Type and Layout - To change the layout of a custom element, 
  1544.                         to change whether it has a closing tag or not, and 
  1545.                         to change its type (normal, input element or 
  1546.                         plugin).
  1547.         
  1548.         Remove Attributes - To remove one or more of the attributes you have 
  1549.                         added to some element, or to remove choices you 
  1550.                         have added to an attribute.  You are first 
  1551.                         presented with a list of all elements you have 
  1552.                         added attributes to.  Select the element you want 
  1553.                         and you are then presented with a list with all 
  1554.                         attributes you have added to this element, where you 
  1555.                         can select the ones you want to remove.  If you 
  1556.                         have only added new choices to an attribute, only 
  1557.                         these choices are removed, not the attribute 
  1558.                         itself.
  1559.                         
  1560.                         There is no function to directly change an 
  1561.                         attribute.  (This is something I hopefully will get 
  1562.                         around to add someday.)  To change an attribute you 
  1563.                         have to first remove it and then add a new one 
  1564.                         again.
  1565.         
  1566.         Remove Additions - To remove an element you have added or to remove 
  1567.                         additions you have made to a predefined element.  
  1568.                         With this function you remove all additions you 
  1569.                         have made to an element.
  1570.         
  1571.                     
  1572.     Move Files… - To move files between different folders, automatically 
  1573.                 updating all links which points to any of these files in 
  1574.                 every file in a home page folder or include folder, as well as 
  1575.                 updating all links in the moved files.
  1576.     
  1577.                 *) First you are asked to select the folder which contains 
  1578.                 the files you want to move.
  1579.                 *) Then you are asked to select the files you want to move 
  1580.                 from this folder.                
  1581.                 *) And then you are asked to select the destination folder.
  1582.                 
  1583.                 Alpha then moves the files and then asks you if you want to 
  1584.                 update all links (this is the whole point of this function, 
  1585.                 so a 'yes' should be appropriate).  Depending on if you 
  1586.                 have moved files in a home page folder or an include 
  1587.                 folder, the following will happen.
  1588.                 
  1589.                 If you have moved files in a home page folder which does not 
  1590.                 have a corresponding include folder
  1591.                 *) the links in all HTML files (as determined by the suffix 
  1592.                 mapping) pointing to the moved files, will be updated.
  1593.                 *) all links in the moved files are updated.
  1594.                 
  1595.                 If you have moved files in a home page folder which has a 
  1596.                 corresponding include folder
  1597.                 *) the links in all HTML files in the home page folder
  1598.                 pointing to the moved files, will be updated.
  1599.                 *) all links in the moved files are updated.
  1600.                 *) the links in all HTML files in the include folder pointing 
  1601.                 to the moved files, will be updated.
  1602.                 (In this case you can optionally choose to only update the
  1603.                 home page folder or include folder, but normally you should
  1604.                 update both.)
  1605.                 
  1606.                 If you have moved files in an include folder
  1607.                 *) all links in the moved files are updated
  1608.                 *) all include tags in the HTML files in the home page 
  1609.                 folder pointing to the moved files are updated.
  1610.                 
  1611.                 Updating links may take a little while if you have very 
  1612.                 many files but should in most cases be a lot faster than 
  1613.                 to make the changes manually.
  1614.                 
  1615.                 Limitations:
  1616.                 • Links within comments , <!-- -->, are also updated (which 
  1617.                 is a bug or a feature, depending on how you see it).
  1618.                 • Alpha only searches for strings like HREF="file" without 
  1619.                 checking that they are inside a tag. This means that Alpha 
  1620.                 could find links, which actually are not links.
  1621.                 • You can only move files between subfolders in one home 
  1622.                 page folder, not between the different home page folders.
  1623.                 • Only files in the home page folder where you move 
  1624.                 files are updated, not the files in any other home page 
  1625.                 folder.
  1626.  
  1627.     Last Modified… - Adds tags to the document which makes it possible to 
  1628.                 automatically add the date and time when the document is 
  1629.                 saved. Two tags inside HTML comments are inserted:
  1630.                 
  1631.                 <!-- #LASTMODIFIED TEXT="some text" FORM="date format" -->
  1632.                 some text and date
  1633.                 <!-- /#LASTMODIFIED -->
  1634.                 
  1635.                 Whenever the document is saved the date is changed.  Don't 
  1636.                 write anything between the comment tags.  It will be removed 
  1637.                 when the document is saved.
  1638.                 
  1639.                 Character translation is done automatically of the text and date.
  1640.                 
  1641.                 In the dialog window you can specify:
  1642.                 *) the text before the date. (Default: Last modified)
  1643.                 *) the date format, long, abbreviated or short. On an American 
  1644.                    system these are:
  1645.                    Saturday, October 19, 1996 9:10 PM
  1646.                    Sat, Oct 19, 1996 9:10 PM
  1647.                    10/19/96 9:10 PM
  1648.                 *) if the weekday should be included in the date. (Does not 
  1649.                    apply to the short format.)
  1650.                 *) if the time should be included in the date.
  1651.                 
  1652.                 If you want to change how the date is displayed, just use 
  1653.                 'Last modified' again and the tags will be replaced.  It is 
  1654.                 not possible to have more than one pair of tags in a 
  1655.                 document.
  1656.  
  1657. Use Attributes    - If you choose to input attributes from the status bar, you 
  1658.                 can select which ones you want to be asked about.  If you 
  1659.                 choose to be asked about attributes in a dialog box you 
  1660.                 will always be asked about all attributes.
  1661.                                 
  1662.                 This menu is disabled if you choose to input attributes in 
  1663.                 a dialog box with all attributes (the default).
  1664.  
  1665.                 For inputting attributes in the status bar, HTML mode is by 
  1666.                 default set to ask about the ones which I think are the most 
  1667.                 popular.  If you choose to use the status bar 
  1668.                 to input attributes I recommend that you go through the 
  1669.                 list and choose the ones you want.  In this list 'LI IN UL'
  1670.                 and 'LI IN OL' are the LI element for UL and OL lists 
  1671.                 respectively.  BUTTON, CHECKBOX, FILE, HIDDEN, IMAGE, 
  1672.                 PASSWORD, RADIO, RESET, SUBMIT and TEXT are the INPUT 
  1673.                 element with different TYPEs.  LIVEAUDIO, LIVEVIDEO, 
  1674.                 QUICKTIME MOVIE, QUICKTIME VR and REALAUDIO are different 
  1675.                 plug-ins.  All the rest are the usual names of the 
  1676.                 elements.
  1677.                 
  1678.                 There is also a question "Ask for more?" If you answer yes, 
  1679.                 the following will happen when you are asked about 
  1680.                 attributes for this element:
  1681.                 *) You are first asked about the ones you have selected via 
  1682.                 this menu.
  1683.                 *) Then you get a question "More attributes?"
  1684.                 *) If you answer yes, you will then be asked about the rest 
  1685.                 of the attributes.
  1686.                 The idea is that you can put a kind of halfway mark.  
  1687.                 First you are asked about the ones you always want to be 
  1688.                 asked about, and then you are optionally asked about the 
  1689.                 rest.
  1690.                 
  1691.                 Note: The settings only affect the current HTML package.  
  1692.                 You have to set everything for both packages even if an 
  1693.                 element is in both of them.  This is because some elements 
  1694.                 have different attributes in the different packages.
  1695.                         
  1696. New Document -    To insert the elements HTML, HEAD, TITLE, BODY in a new 
  1697.                 HTML document.  If you have a text file which you want to 
  1698.                 make into an HTML file, this function lets you put the text 
  1699.                 into the document's BODY element.  Before choosing "New 
  1700.                 document", open a new empty window or a text file which you 
  1701.                 want to make into an HTML document.
  1702.  
  1703.                 First a dialog box appears where you can:
  1704.                 *) give the document a title, 
  1705.                 *) choose elements you want, which can be in the HEAD. 
  1706.                 (These elements can of course be inserted later.)
  1707.                 *) choose a footer which is inserted in the end of the BODY 
  1708.                 element.  You define a file to be a footer via the menu item 
  1709.                 Footers.
  1710.                 
  1711.                 When you are finished with the first dialog box 
  1712.                 you are then asked about attributes for each element you 
  1713.                 have chosen to put in the HEAD, and finally you are asked 
  1714.                 about attributes for the BODY element.  
  1715.                 
  1716.                 The elements <HTML>, <HEAD>, <TITLE>, your chosen ones, and 
  1717.                 <BODY> are now inserted in the text.  If there was text in 
  1718.                 the document, it is put in the BODY before the text in the 
  1719.                 footer.
  1720.  
  1721. Now comes the part of the menu with all HTML elements.  Some of the menu 
  1722. items for the elements are dynamic.  Hold down the option key and you see 
  1723. that some menu items change.  The new ones which appear insert the same 
  1724. element as the other ones but with all attributes automatically skipped.  
  1725. ("No attr" in the menu stands for "no attributes").  The elements which 
  1726. this concerns are <H1>-<H6>, <P>, <DIV>, <BR>, <HR>, <UL>, <OL>, <TR>, <TH> 
  1727. and <TD>.  This can be very useful if you for example are making a table 
  1728. and only for a few cells want to set some attributes.
  1729.  
  1730. Headers    -        Insert section headers, from H1 to H6.
  1731.  
  1732.     Header n  -    <Hn>.
  1733. <opt> Hn no attr -    <Hn> without attributes.
  1734.  
  1735. Blocks and Dividers    -    These are various text-blocks and elements to control
  1736.                 line breaks. 
  1737.                 
  1738.     Insert Line Breaks - Insert a <BR> tag at the end of each line in a 
  1739.                 selection.  To use this, first select the text where you 
  1740.                 want the <BR> tags.
  1741.     
  1742. <opt>Remove Line Breaks - Removes all <BR> tags in a selection (not only 
  1743.                 the ones at end of lines).  To use this, first select the 
  1744.                 text where you want to remove the <BR> tags.
  1745.                 
  1746.     Insert Paragraphs -    Insert <P> elements at each empty line in a selection, 
  1747.                 and one just before the selection.  To use this, first 
  1748.                 select the text where you want the <P> elements.
  1749.                 
  1750.     Paragraph     -    <P>
  1751. <opt>P no attr     -     <P> without attributes.
  1752.     Division     -    <DIV>
  1753. <opt>DIV no attr -     <DIV> without attributes.
  1754.     Block Quote -     <BLOCKQUOTE>
  1755.     Address        -    <ADDRESS>
  1756.     Center        -    <CENTER>
  1757.     Preformatted -    <PRE>
  1758.     Multi Column -    <MULTICOL>
  1759.     Spacing        -    <SPACER>
  1760.     Line Break    -    <BR>
  1761. <opt>BR no attr -    <BR> without attributes.
  1762.     Horizontal Rule - <HR>
  1763. <opt>HR no attr    -    <HR> without attributes.
  1764.     No Line Break -    <NOBR>
  1765.     Word Break    -    <WBR>
  1766.     
  1767. Styles    -        Elements for different text styles.  The ones above the 
  1768.                 line in the middle of the menu are physical styles, while 
  1769.                 the other ones are logical styles.
  1770.     
  1771.     Font        -    <FONT>
  1772.     Basefont    -    <BASEFONT>
  1773.     Bold        -    <B>
  1774.     Italic        -    <I> 
  1775.     Strike out    -    <STRIKE>
  1776.     Underlined    -    <U>
  1777.     Superscript -    <SUP>
  1778.     Subscript    -    <SUB>
  1779.     Bigger        -    <BIG>
  1780.     Smaller        -    <SMALL>
  1781.     Typewriter    -    <TT>
  1782.     Blinking    -    <BLINK>
  1783.     Emphasis    -    <EM>
  1784.     Strong        -    <STRONG>
  1785.     Definition    -    <DFN>
  1786.     Code        -    <CODE>
  1787.     Variable    -    <VAR>
  1788.     Citation    -    <CITE>
  1789.     Keyboard    -    <KBD>
  1790.     Sample        -    <SAMP>
  1791.  
  1792. Links    -        Hypertext links to and from other points, plus images.
  1793.     Link or Anchor - <A>
  1794.     Image        -    <IMG>
  1795.  
  1796. Plug-ins  -        Different plug-ins all using <EMBED>
  1797.     General        -     General <EMBED> tag.
  1798.     LiveAudio etc. -  Plug-ins with more attributes to <EMBED>.
  1799.     No Embed    -    <NOEMBED>
  1800.     
  1801. Lists    -        All kinds of lists. 
  1802.  
  1803.     Make List    -    Makes a list of the text in a selection.  If you, 
  1804.                     for example, have a list 
  1805.                     
  1806.                     * item one
  1807.                     * item two 
  1808.                     * item two
  1809.                     and a half
  1810.                     * item three
  1811.                     
  1812.                     you can make an HTML list of them.  First select the 
  1813.                     lines with the items, before you choose "Make list" 
  1814.                     from the menu.  You are then presented with a dialog 
  1815.                     where you can specify
  1816.                     *) a string with which all list items must begin, in 
  1817.                     this case *.  You cannot transform a list where the 
  1818.                     items begins with 1), 2) etc.  All items must begin 
  1819.                     with the same string.
  1820.                     *) Which kind of list you want.  Choose 'None' if you 
  1821.                     don't want the list tags to be inserted, for example if 
  1822.                     you are inserting new items in an existing list.
  1823.                      
  1824.                     The result in this case will be
  1825.                     
  1826.                     <UL>
  1827.                     <LI>item one
  1828.                     <LI>item two
  1829.                     <LI>item two
  1830.                     and a half
  1831.                     <LI>item three
  1832.                     </UL>
  1833.                         
  1834.     Bulleted    -    <UL> list.
  1835. <opt>UL no attr    -    <UL> without attributes.
  1836.     New Bulleted Item - <LI> with attributes corresponding to an <UL> list.
  1837.     Ordered        -    <OL> list.
  1838. <opt>OL no attr    -    <OL> without attributes.
  1839.     New Ordered Item -    <LI> with attributes corresponding to an <OL> list.
  1840.     Directory    -    <DIR> list.
  1841.     Menu        -    <MENU> list.
  1842.     New List Item -    <LI> without attributes.
  1843.     Discursive    -    <DL> list.
  1844.     New Discursive Entry -    <DT> and <DD>
  1845.     
  1846.     When you make a list you are first asked how many items you want and, 
  1847.     in some cases, if you want to be asked about attributes for each list 
  1848.     item.  You are then asked about attributes for the list element and 
  1849.     finally, if you have said so, about attributes for each list item.
  1850.     
  1851. Forms    -        The elements for building forms.
  1852.  
  1853.     Form        -    <FORM>
  1854.     Text        -    <INPUT TYPE=TEXT>
  1855.     Checkbox    -    <INPUT TYPE=CHECKBOX>
  1856.     Button        -    <INPUT TYPE=BUTTON>
  1857.     Radio        -    <INPUT TYPE=RADIO>
  1858.     Submit        -    <INPUT TYPE=SUBMIT>
  1859.     Reset        -    <INPUT TYPE=RESET>
  1860.     Password    -    <INPUT TYPE=PASSWORD>
  1861.     Hidden        -    <INPUT TYPE=HIDDEN>
  1862.     Image        -    <INPUT TYPE=IMAGE>
  1863.     File Upload    -    <INPUT TYPE=FILE>
  1864.     Select        -    <SELECT>
  1865.     Option        -    <OPTION>
  1866.     Textarea    -    <TEXTAREA>
  1867.     
  1868. Tables    -        The elements for building tables.
  1869.  
  1870.     Table Template… - A function to easily build a table if it does not have 
  1871.                     too complicated a structure.  You are presented with a 
  1872.                     dialog box where you can specify:
  1873.                     *) the number of rows and columns you 
  1874.                     want.  
  1875.                     *) whether you want table headers (TH) in the first row 
  1876.                     and/or the first column.  The rest will be table cells 
  1877.                     (TD).
  1878.                     *) whether or not you want TABLE tags.  Skip the table tags 
  1879.                     if you want to insert new rows in an existing table.                    
  1880.                     *) attributes for TABLE.
  1881.                     *) attributes for TR. These attributes will be the same 
  1882.                     for every row.
  1883.                     
  1884.                     You cannot use this function to build more complicated 
  1885.                     tables which requires attributes such as ROWSPAN and 
  1886.                     COLSPAN.
  1887.     
  1888.     Tabs to Rows -    Takes a tab-delimited table and make HTML table rows.  
  1889.                     To use this, first select the text to make table 
  1890.                     rows of before you choose "Tabs to Rows" from the menu.
  1891.                     
  1892.                     Example: If you have the lines
  1893.                     
  1894. a    b    c
  1895. d    e    f
  1896.                     in your document, "Tabs to Rows" will transform them into
  1897.  
  1898. <TABLE>
  1899.             
  1900. <TR>
  1901. <TD>a</TD><TD>b</TD><TD>c</TD>
  1902. </TR>
  1903.  
  1904. <TR>
  1905. <TD>d</TD><TD>e</TD><TD>f</TD>
  1906. </TR>
  1907.  
  1908. </TABLE>
  1909.                       
  1910.                     Do not put more than one tab between each table cell.  
  1911.                     Alpha makes one table cell for each tab in each row.  
  1912.                     
  1913.                     When you use this function you are presented with a 
  1914.                     dialog box where you can specify:
  1915.                     *) whether you want table headers (TH) in the first row 
  1916.                     and/or the first column.  The rest will be table cells 
  1917.                     (TD).
  1918.                     *) whether or not you want TABLE tags.  Skip the table tags 
  1919.                     if you want to insert new rows in an existing table.                    
  1920.                     *) attributes for TABLE.
  1921.                     *) attributes for TR. These attributes will be the same 
  1922.                     for every row.
  1923.                     
  1924.                     
  1925. <opt>Rows to Tabs - Converts table rows in a selection to a tab-delimited 
  1926.                     format.  (This is "Tabs to Rows" backwards.)  
  1927.                     To use this, first select the table rows you want to 
  1928.                     convert.  This function will remove the elements TR, TH 
  1929.                     and TD, and put one tab between each table cell.  
  1930.                     Everything in each table row will be put on one line.  
  1931.                     If the table contains cells of varying length you may 
  1932.                     have to change the tab size for the table to look 
  1933.                     pretty. This function does not remove the surrounding 
  1934.                     TABLE tags.
  1935.     
  1936.     Import Table… - Function to import a tab delimited table from a file.  
  1937.                     This works just like 'Tabs to Rows' except that the 
  1938.                     table is read from a file rather than being selected in 
  1939.                     the document.
  1940.     
  1941.     Table        -    <TABLE>
  1942.     Row            -    <TR>
  1943. <opt>TR no attr -    <TR> without attributes.
  1944.     Header        -    <TH>
  1945. <opt>TH no attr    -    <TH> without attributes.
  1946.     Cell        -    <TD>
  1947. <opt>TD no attr    -    <TD> without attributes.
  1948.     Caption        -    <CAPTION>
  1949.  
  1950. Frames  -        The elements for building frames. 
  1951.     
  1952.     New Doc. with Frames - The same as New document, with the difference 
  1953.                     that BODY is replaced by FRAMESET.
  1954.     
  1955.     Frameset    -    <FRAMESET>
  1956.     Frame        -    <FRAME>
  1957.     No Frames    -    <NOFRAMES>
  1958.  
  1959. Image Maps -    The elements for client side image maps.
  1960.  
  1961.     Convert NCSA Map… - Lets you select an image map file for the NCSA server, 
  1962.                     converts it to a client side image map definition, and 
  1963.                     inserts it at the current position in the document.
  1964.     
  1965.     Convert CERN Map… - The same function for image map files for the CERN 
  1966.                     server.
  1967.                 
  1968.                     If you know the syntax for image map files for any 
  1969.                     other server, please tell me and I'll add it.
  1970.     
  1971.     Map            -    <MAP>
  1972.     Area        -    <AREA>
  1973.  
  1974. Java    -         The elements for Java and JavaScript.
  1975.  
  1976.     Applet        -    <APPLET>
  1977.     Parameter    -    <PARAM>
  1978.     Script        -    <SCRIPT>
  1979.     No Script     -    <NOSCRIPT>
  1980.  
  1981. Other     -        Things which do not fit elsewhere. 
  1982.  
  1983.     Comment        -    Inserts a HTML comment <!-- -->, or a JavaScript comment
  1984.                     /*  */ if the insertion point is inside a SCRIPT container.
  1985.     Base        -    <BASE>
  1986.     Isindex        -    <ISINDEX>
  1987.     Link        -    <LINK>
  1988.     Meta        -    <META>
  1989.     Comment Line -    Inserts a commented line with = signs.  Use it if you 
  1990.                     want to divide the document into different parts. The
  1991.                     key binding for this is ctrl-C-L.
  1992.  
  1993. Character Entities    - The entities for characters, for example ü is ü.  
  1994.                 All possible entities are divided into three submenus. 
  1995.                 Picking a character from these menus is only useful if you 
  1996.                 only want a single character.  If you write in a language 
  1997.                 which use a lot of these characters, type them in the 
  1998.                 document as usual and then use the character translation.
  1999.                 
  2000.     Add     -        Letters can be added to the short list at the top.
  2001.                     Choose the ones you want from a pick list.
  2002.                     
  2003.     Default -        Sets the short list at the top back to the default 
  2004.                     setting: less than, greater than, ampersand.
  2005.     
  2006.     Clear    -        Removes all letters from the short list.
  2007.                         
  2008.     Small Chars -    Inserts the character entity for a letter, for example, 
  2009.                     á inserts á.
  2010.                     
  2011.     Capital Chars -    Inserts the character entity for a capital letter.
  2012.     
  2013.     Other Chars    -    Character entities for other characters.
  2014.     
  2015.      The reason for the accent being beside some letters is that the font 
  2016.      used in the menus, Chicago, does not have these accented letters.
  2017.  
  2018. ===============================================================================
  2019. = Settings
  2020. ===============================================================================
  2021.  
  2022. HTML mode is highly customizable.  You can modify its behavior in several 
  2023. ways.  
  2024.  
  2025. Use Config -> Current mode -> Flags... to change the settings.
  2026.  
  2027. General
  2028.  
  2029. Bring browser to front when sending a window to it
  2030. If checked, when you send a file to the browser, the browser will be 
  2031. brought to the foreground.  If you have lots of screen space and are just 
  2032. validating, uncheck this flag to leave the browser in the background and 
  2033. Alpha in the foreground.  By default the browser is brought to the foreground.
  2034.  
  2035. Save window without asking when sending it to the browser
  2036. If checked, when you send a file to the browser, the window is saved 
  2037. automatically without asking you. By default you are asked if you want to 
  2038. save the window.
  2039.  
  2040. Set tags in lower case
  2041. If not checked, elements will be like <P>; if checked, like <p>.  By 
  2042. default upper case is used.
  2043.                         
  2044. Use tab marks (•)
  2045. If checked, will insert the • characters.  By default the • characters 
  2046. are inserted.
  2047.  
  2048. <P> has a closing tag </P>
  2049. If checked, the <P> element has a corresponding closing tag.  If not 
  2050. checked it does not.  By default it has a closing tag.
  2051.  
  2052. <LI>, <DT> and <DD> have closing tags
  2053. If checked, <LI>, <DT> and <DD> have corresponding closing tags.  If not 
  2054. checked the optional closing tags are skipped.  By default they do not 
  2055. have closing tags.
  2056.  
  2057. Give attributes in dialog windows, not in the status bar
  2058. If checked, element attributes will be asked about in a dialog box with 
  2059. all attributes, otherwise they will be asked about in the status bar.  By 
  2060. default dialog boxes are used.
  2061.  
  2062. Beep for each attribute (applies only if you use the status bar)
  2063. If checked, and you input element attributes from the status bar, Alpha 
  2064. will beep when asking for element attribute information there.  By default 
  2065. Alpha will beep.  This applies only if you use the status bar.
  2066.  
  2067. Color of HTML tags
  2068. The color of the HTML tags.  The default is blue.  
  2069.  
  2070. JavaScript
  2071.  
  2072. Color JavaScript keywords
  2073. If checked, keywords and comments in JavaScript will be colored.  The way 
  2074. the HTML tags are colored is also changed because the old way does not work 
  2075. well with JavaScript.  By default JavaScript keywords are not colored.
  2076.  
  2077. Electric left braces
  2078. When checked, the left braces, {, will be electric like in C mode.  Check 
  2079. this if you are editing JavaScript.  By default { is not electric.
  2080.  
  2081. Electric right braces
  2082. When checked, the right braces, }, will be electric like in C mode.  Check 
  2083. this if you are editing JavaScript.  That { is electric means that a 
  2084. carriage return will automatically be inserted and the next line will be 
  2085. indented when you type {.  By default } is not electric.
  2086.  
  2087. Include event handlers in attribute dialog
  2088. When checked, the event handlers (onFocus onSelect etc.)  will appear in 
  2089. the attribute dialog.  By default event handlers will not appear in 
  2090. the attribute dialog.
  2091.  
  2092. Color of JavaScript keywords
  2093. The color of keywords in JavaScript.  Applies only if you choose to color 
  2094. JavaScript keywords. The default is magenta.
  2095.     
  2096. Color of JavaScript comments
  2097. The color of comments in JavaScript.  Applies only if you choose to color 
  2098. JavaScript keywords. The default is red.
  2099.  
  2100. Color of strings
  2101. The color of everything between quotes.  Applies only if you choose to 
  2102. color JavaScript keywords.  The default is green.
  2103.  
  2104. Checking links
  2105.  
  2106. Check anchors
  2107. When checked, 'Check links' will check that there is an anchor 
  2108. <A NAME="anchor"> in file.html if a link <A HREF="file.html#anchor"> points
  2109. to it. By default anchors are checked.
  2110.  
  2111. Case sensitive checking (slower)
  2112. When checked, 'Check Links' will check that the case in the links match the 
  2113. case in the file and folder names. This can be useful as Mac file names 
  2114. are not case sensitive, while for example unix file names are. Case 
  2115. sensitive checking is slower, and therefore not done by default. If you 
  2116. send the files to Big Brother, case sensitive checking will not be done, as 
  2117. Big Brother can't do that.
  2118.  
  2119. Bring Big Brother to front when checking links
  2120. If you use Big Brother to check links, this will determine if Big Brother 
  2121. stays in the background or not, when you send files to it. By default Big 
  2122. Brother is brought to the front.
  2123.  
  2124. Use Big Brother's link check options
  2125. When not checked, the settings for the two links checking options below will 
  2126. used instead of the correspoding options in Big Brother. By default
  2127. Big Brother's settings are used.
  2128.  
  2129. Ignore remote links
  2130. The same as the corresponding option in Big Brother.
  2131.  
  2132. Ignore local links
  2133. The same as the corresponding option in Big Brother.
  2134.  
  2135. Word Wrapping
  2136.  
  2137. Line width
  2138. Determines at which position lines are wrapped. This is the HTML mode 
  2139. specific version of the variable fillColumn in the global settings dialog.
  2140.  
  2141. wordBreak            - These two control which characters build up words,
  2142. wordBreakPreface     - 
  2143. wrapBreak            - and these ones control word wrapping.
  2144. wrapBreakPreface    -
  2145.                     Read about them in the general manual if you want to 
  2146.                     change them (should usually not be needed).
  2147.  
  2148. Internal variable which you may change
  2149.  
  2150.     HTMLwords    -    keywords which you want to be highlighted when editing 
  2151.                     HTML in Alpha.  They are colored with the same color as 
  2152.                     the HTML elements.  If you want the words "cool" and 
  2153.                     "nifty" to be highlighted, add the following to your 
  2154.                     preferences file:
  2155.                 
  2156.             lappend HTMLwords cool nifty
  2157.             htmlColorizing
  2158.             
  2159.                     The first line defines the words and the second one 
  2160.                     tells Alpha to color them.  By default there are no 
  2161.                     keywords.
  2162.  
  2163. ===============================================================================
  2164. = HTML Tutorials, References and Validation
  2165. ===============================================================================
  2166.  
  2167. A Beginner's Guide To HTML,
  2168. http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html
  2169.  
  2170. The Web Design Group
  2171. http://www.htmlhelp.com/
  2172.  
  2173. Introducing HTML 3.2
  2174. http://www.w3.org/pub/WWW/MarkUp/Wilbur/
  2175.  
  2176. Introduction to HTML and URLs
  2177. http://www.utoronto.ca/webdocs/HTMLdocs/NewHTML/intro.html
  2178.  
  2179. Guide to HTML Commands
  2180. http://www.woodhill.co.uk/html/html.htm
  2181.  
  2182. Creating Net Sites
  2183. http://home.netscape.com/assist/net_sites/
  2184.  
  2185. The Bare Bones Guide to HTML
  2186. http://werbach.com/barebones/
  2187.  
  2188. JavaScript
  2189. http://home.netscape.com/eng/mozilla/3.0/handbook/javascript/
  2190.  
  2191. HTML Validation
  2192. http://www.webtechs.com/html-val-svc/
  2193.